.. _cesPeekByteEx:

cesPeekByteEx
==============
--------------


SYNOPSYS
`````````````
.. code-block:: none

  t_i32 cesPeekByteEx( 
        [in] t_i32 nNodeID, 
        [in] t_i32 nChannel,
        [in] t_i32 nIndex,
        [out] ULONGLONG  byRetVal,
        [out] t_bool  bIsSuccess
    )


DESCRIPTION
`````````````

- 수신 버퍼 내 원하는 위치의 1 바이트 데이터를 읽어옵니다.
- 모두 버퍼 카운트를 감소 시키지 않습니다.



PARAMETER
`````````````
- nNetID : 원격 노드 ID

- nChannel : 채널 번호

- nIndex : 수신 버퍼에서 읽어올 바이트에 대한 위치 인덱스 값을 설정

- byRetVal : 읽은 바이트 데이터를 반환

- bIsSuccess : 함수 수행 여부 반환



RETURN VALUE
`````````````

- 함수 수행 여부를 반환합니다.

+----------------+-----------+
| Value          | Meaning   |
+================+===========+
| 음수           | 수행 실패 |
+----------------+-----------+
| 0 (ceERR_NONE) | 수행 성공 |
+----------------+-----------+



EXAMPLE
`````````````

.. code-block:: cpp
 :linenos:
 :emphasize-lines: 13

 #include "ceSDK.h"
 #include "ceSDKDef.h"
 long nSerialChNo = 0; // 시리얼 채널(Port) 번호
 BYTE byData; // 1 바이트 데이터 정보
 
 // 0 번 시리얼 포트에 대해 수신 버퍼의 첫번째 바이트 데이터 확인
 if ( cesPeekByte ( nSerialChNo, &byData) != ceERR_NONE )
 {
 OutputDebugString ( "cesPeekByte has been failed" );
 }
 
 // 0 번 시리얼 포트에 대해 수신 버퍼의 임의의 위치의 바이트 데이터 확인
 if ( cesPeekByteEx ( nSerialChNo, 5, &byData) != ceERR_NONE ) // zero base 로 6 번째 수신 데이터 확인
 {
 OutputDebugString ( "cesPeekByteEx has been failed" );
 }